."   Copyright (c) 2007 DUDOUET Clément.
."  Permission is granted to copy, distribute and/or modify this document
."  under the terms of the GNU Free Documentation License, Version 1.2
."  or any later version published by the Free Software Foundation;
."  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
."  Texts.  A copy of the license is included in the project in directory
."  [$PROJECT_PATH]/doc/fdl.txt
." Page de manuel de filoo_open
.TH filoo_open 2 "Fevrier 11, 2007" "version 1.0" "Manuel d'utilisateur"
.SH NOM
filoo_open \- Ouverture d'un fichier circulaire filoo
.B existant
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.sp
.BI "int filoo_open(const char *" pathname ", int " flags ");
.SH DESCRIPTION
L'appel système
.BR filoo_open ()
sert a convertir un chemin d'accès en descripteur de fichier.
Le nouveau descripteur de fichier est configuré pour rester ouvert au travers des fonctions exec (voir
.BR fntl (2)).
Le pointeur de position dans le fichier est placé au niveau de la donnée la plus ancienne contenue dans le fichier. 
Le paramètre
.I flags
est l'un des éléments suivants
.BR O_RDONLY ", " O_WRONLY " ou " O_RDWR
qui réclament respectivement l'ouverture du fichier en lecture seule, écriture seule, ou lecture-écriture.
.SH "VALEUR RENVOYEE"
.BR filoo_open
renvoie le nouveau descripteur de fichier s'il réussit, ou \-1 s'il échoue, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
.TP
.B EINCOHERENT
.I pathname
désigne un fichier incohérent au sens des fichiers circulaires (l'entête est incohérent).
.TP
.B EEXIST
.I pathname
ne correspond pas a un fichier existant
.TP
.B EACCES
L'accès demandé au fichier est interdit, ou la permission de parcours pour
l'un des répertoires du chemin
.IR pathname
est refusée, ou le fichier n'existe pas.
.TP
.B ...
cf.
.BR open(2)
.SH "VOIR AUSSI"
.BR filoo_close "(2),"
.BR filoo_create "(2),"
.BR filoo_read "(2),"
.BR filoo_write "(2)"
.SH AUTEUR
Clément DUDOUET
.SH DISPONIBILITE
Le projet est disponible a cette adresse :
.TP
.B http://code.google.com/p/filoo
.TP
Et par l'intermédiaire de SVN en utilisant la commande :
.TP
.B svn checkout http://filoo.googlecode.com/svn/trunk/ filoo
